home *** CD-ROM | disk | FTP | other *** search
/ Aminet 49 / Aminet 49 (2002)(GTI - Schatztruhe)[!][Jun 2002].iso / Aminet / text / misc / OneLine.lha / OneLine / OneLine.doc < prev    next >
Encoding:
Text File  |  2002-04-22  |  12.8 KB  |  496 lines
  1.            / \    |  |   |^^   |     |   |  |   |^^          /|   ^^|
  2.           |   |   |\ |   |--   |     |   |\ |   |--           |   --|
  3.            \_/    | \|   |__   |__   |   | \|   |__      \/.  |.  __|
  4.  
  5.  
  6.           *************************************************************
  7.           *  ONELINE 1.3.2   &   ONELINE 1.3L by  Vincenzo Barbarulo  *
  8.           *************************************************************
  9.  
  10.  
  11.  
  12.  
  13. Introduction
  14. ------------
  15. I've written this program because no freeware program on Aminet converts a
  16. text file in "One Line" only!.
  17. This new version with GUI, also have many others features. See below.
  18. The LIGHT version works only from shell.
  19.  
  20. WHY DO THIS??
  21.  
  22. So, this program is useful when you want to import a text in a DTP or WP program
  23. and you want to put the text in a number of columns greater or different from
  24. the original text.
  25.  
  26. In that case you have to go at the end-line, "DEL" last character and
  27. (not always) press "SPACE", for all the "end-line" of the text.
  28. OneLine do that for you and converts at one time CR,LF,TAB & dblSPACES!!
  29. #
  30.  
  31.  
  32.  
  33.  
  34. Requirements
  35. ------------
  36. For GUI Version:
  37.  
  38.     - Any Amiga with at least OS 3.0, or greater, and some Mb of RAM (!) if you want
  39.       to convert/save big files into RAM. (see History)
  40.       I don't know if OneLine works on OS 2.1
  41.  
  42.     - ReqTools.library  by  Nico Francois (AMINET, see Legal stuff) (included)
  43.  
  44.     - MPCenturyBold.type font  by  Manolis S. Pappas (AMINET, see Legal stuff) (included)
  45.  
  46.  
  47.     optionally:
  48.  
  49.     - Multiview, EditPad, CygnuED in the path  ->
  50.       Multiview  in  "SYS:Utilities/"  directory
  51.       EditPad    in  "SYS:Tools/"      directory
  52.  
  53.       if you want to show the ASCII files.
  54.  
  55.  
  56.     NOTE about CygnusED:
  57.     OneLine search for 'Ced' in the path.
  58.  
  59.  
  60.     NOTES:
  61.     - OneLine Internal viewer needs only  'CON:'  device mounted  (!)
  62.  
  63.     - If OneLine don't find a viewer,    -> check the path
  64.  
  65.  
  66. for Shell Version:
  67. Any Amiga :)
  68. #
  69.  
  70.  
  71.  
  72.  
  73. Installation:
  74. -------------
  75. Double Click on Install_OneLine icon.
  76.  
  77.  or
  78.  
  79. Manually:
  80.  
  81.     type in shell:
  82.  
  83.     Lha -x x OneLine.lha RAM:
  84.     cd RAM:
  85.     Copy OneLine & OneLine.info  ->  ANY PATH
  86.     Copy libs/ReqTools.library LIBS:
  87.     Copy Fonts/#? FONTS: all
  88.     Copy OneLine.doc HELP:
  89.  
  90. NOTE:
  91. If OneLine don't recognize the fonts, try to run
  92. Intellifont and/or FixFonts  (in SYS:System)
  93. #
  94.  
  95.  
  96.  
  97.  
  98. Features
  99. --------
  100.  - FREEWARE. No requesters and no expiry date.
  101.  - Uses ReqTools.library
  102.  - Detect CR, LF, TAB
  103.  - Detect multiples spaces
  104.  - Detect the spaces before comma
  105.  - Add a space after comma if it isn't
  106.  - Remove the characters non ASCII code 0-127
  107.  - Show results of the conversion
  108.  - Shortcuts for all the functions
  109.  - Uses various viewers:
  110.    Multiview, EditPad, CygnusED & OneLine internal (with CON:)
  111.  - (very!) Simple print ASCII file
  112.  - (This) HELP on line
  113.  - Shortcuts on ListView in main Window
  114.  - GUI, with gadtools.library (for compatibility with all machines)
  115.  
  116.  
  117. I've tested this program on my:
  118.  
  119. A4000, CyberStormMKIII 060/50, 128Mb RAM, CVisionPPC, OS 3.5,
  120. HD9.1Gb ATLAS SCSI-UW, HD10.5Gb Samsung IDE, CanonBJC-4400,
  121. MustekParagon-1200SP, CDROM 48x
  122.  
  123. and same A4000 but OS3.1
  124.  
  125.  
  126. Speed NOTE:
  127. On my A4000 OneLine converts and saves a file of ~600Kb of text in ~2 - ~2.5 secs
  128. and another of ~3500Kb in ~13 secs, but the speed depends by the file
  129. (number of the spaces and/or TAB). (LIGHT version)
  130.  
  131. Speed NOTE 2:
  132. With only the CR-LF option OneLine is very fastest than CR-LF & others options,
  133. because jump many checks..
  134. #
  135.  
  136.  
  137.  
  138.  
  139. SHELL USAGE:
  140. ------------
  141.                               |^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^|-> (any order)
  142. Type:  Oneline <in_file_path>  <out_file_path> -t -d -c . . . STDOUT
  143.  
  144.        <in_file_path>   Name and path of the file to convert
  145.  
  146.        <out_file_path>  Name and path of the destination file
  147.  
  148.        -t               TAB option: if it's present, the program erases the TAB 
  149.                         characters too
  150.  
  151.        -d               Multiples Spaces Option: if it's present, the program
  152.                         erases the multiples spaces adjacents
  153.  
  154.        -c               Comma OPTIMIZE: if it's ON, OneLine erases the spaces
  155.                         before the ',' chr. and add a space after ',' if isn't present.
  156.  
  157.        -l               CR-LF option: if it's present, the program erases CR & LF
  158.                         characters (code).
  159.                         It's agreable to use with -L option together
  160.  
  161.        -p               Leave Paragraph option: if it's present OneLine will
  162.                         work only IN the paragraph
  163.  
  164.        -e               Error Checking: recognize the sequences :. ,: ,. etc.
  165.                         and change them (ask)
  166.  
  167.        -L               With this option OneLine only CONVERTS CR to LF
  168.                         (don't erases CR: with the programs that don't recognizes the CR,
  169.                         the text seems to be the same of the original)
  170.      
  171.        -A               ALL Options: if it's typed, OneLine add all options
  172.                         (like: -t -c -l -m -p -e   or   -tclmpe)
  173.  
  174.  
  175.        STDOUT           is the file "RAM:STDFile_OneLine.txt" that is used if
  176.                         isn't destination file specified
  177.  
  178. NOTE: The options can be written all togethers like:  -ctdl
  179.       or separated: -t -d -l -c
  180.  
  181. NOTE: You can open the GUI typing only the name of the program without any argument
  182.       (i.e. "2.SYS:> ..path to../Oneline")
  183. #
  184.  
  185.  
  186.  
  187.  
  188. WB USAGE:
  189. ---------
  190. Simply doubleclick on the icon...
  191.  
  192. Gadgets:
  193.  
  194. EXIT          Exit with requester "yes - no"
  195.  
  196. CloseWIN GAD  Exit quiet
  197.  
  198. Info          Info about program and author
  199.  
  200.  
  201. Input FILE    The file to be processed (string)
  202. ?             requester
  203.  
  204.  
  205. Output FILE   The OUTPUT file (string)
  206. ?             requester
  207.  
  208.  
  209. Columns to    The name of the file with the specified number of columns
  210. ?             requester
  211.  
  212.         NOTE: Note that "Columns to" uses "Output FILE" field as INPUT and
  213.               "Columns to" field as OUTPUT
  214.               (saved with "Save with" number of columns)
  215.  
  216.  
  217. Save with     Max. number of columns for the file in 'Columns To' field
  218.  
  219.         NOTE: If in the text ther're some TABS, the Text shown seem to be not
  220.               formatted: this is because the TABS is 1 character too, like others,
  221.               but take up more space...
  222.               You should use 'Erase TAB' option to remove this 'problem'
  223.  
  224.         NOTE: To use this option, OneLine needs a valid entry
  225.               in "Output FILE:" field:  NOT the STDOUT file!!!
  226.  
  227.  
  228. Print         Simply send the file selected, to PRT: one Character at the same
  229.               ( about like  " type <filename> >PRT:"  from shell)
  230.  
  231.  
  232. GO            Begin conversion
  233.  
  234.  
  235. Show(1,2,3)   Show with the selected viewer
  236.  
  237.  
  238. Multiview,
  239. EditPad,
  240. CygnusED,
  241. OneLine       The viewer used by 'Show' Gadgets
  242.  
  243.     NOTE: Multiview, EditPad & OneLine don't recognizes the CR, but only LF
  244.  
  245.  
  246.  
  247. OPTIONS:
  248. ALL Options   Include all options
  249.  
  250.  
  251. AUTO View     OneLine automatically show the files, at the end of conversion
  252.               (with the 'Show with' viewer)
  253.  
  254.  
  255. CR-LF         OneLine detect and remove CR & LF (convert to 'One'line only)
  256.  
  257.  
  258. Erase TAB     OneLine detect and remove TABS
  259.  
  260.  
  261. Multiple-SPC  OneLine detect and remove the consecutives spaces
  262.               i.e.
  263.               "The  viewer    used  by 'Show'   Gadgets" ->
  264.               "The viewer used by 'Show' Gadgets"
  265.  
  266.  
  267. Check CHRS    Convert the sequences of :.  ,: ,"  etc.
  268.               to -> one character inserted by the user
  269.  
  270.  
  271. Leave EOfPar  Preserve the paragraph's separations
  272.  
  273.  
  274. Comma OPTIM.  If checked, OneLine attach  , . : ;  to the precedent word;
  275.               " ' to the respective word or phrase
  276.  
  277.  
  278. SPC at BEGIN  With this option OneLine erases the (empty) spaces at begin
  279.               of the line in the FORMATTED text. (Only in GUI version)
  280.  
  281.  
  282. CRtoLF        With this option OneLine only CONVERTS CR to LF
  283.               (don't erases CR: with the programs that don't recognizes the CR,
  284.               the text seems to be the same of the original)
  285.  
  286. NOTE:
  287. See in 'example' dir for some examples
  288. #
  289.  
  290.  
  291.  
  292. Legal stuff
  293. -----------
  294. - OneLine is freeware. It may be distributed freely as long as
  295.   no modifications are made to the executable and to this document.
  296.  
  297.   ...but if you send me an EMail also empty(!) with the subject
  298.   "OneLine user!" you make me greater!!!:
  299.   only would i know how many peoples uses this program!
  300.  
  301.  
  302. OneLine uses these thirdy parts FREEWARE software:
  303.  
  304. - ReqTools.library
  305.   | © 1991-1994 by Nico François     (nico@augfl.be)
  306.   | © 1995-1997 by Magnus Holmgren   (cmh@lls.se)
  307.   |
  308.   | Magnus Holmgren
  309.   | Kvarnbergsvägen 5
  310.   | S-444 47  Stenungsund
  311.   | SWEDEN
  312.   | 
  313.   |http://uk.aminet.net/pub/aminet/util/libs/ReqToolsDev.lha (for developers)
  314.   |http://uk.aminet.net/pub/aminet/util/libs/ReqToolsUsr.lha (for users)
  315.   |___
  316.   
  317.  
  318. - MPCenturyBold.type  © by  Manolis S. Pappas
  319.   |
  320.   | Thermopilon 24
  321.   | 14231 Nea Ionia
  322.   | Athens HELLAS
  323.   |
  324.   |EMAIL: mpappas@ba.aegean.gr
  325.   |       infinity@acropolis.net
  326.   |
  327.   |ftp://main.aminet.net//systems/amiga/aminet/text/ifont/MPFonts3_AGFA.lha
  328.   |___
  329.  
  330.  
  331. Compiled with VBCC.
  332.  V0.8 (c) in 1995-2001 by Volker Barthelmann
  333.  
  334.  http://it.aminet.net/pub/aminet/dev/c/vbcc.lha
  335. #
  336.  
  337.  
  338.  
  339.  
  340. BUGS
  341. ----
  342. Nothing, at this moment!!
  343.  
  344. If you find a bug please send me an Email with the subject
  345. "OneLine bug" and tell me your configuration.
  346. ( and the file with the 'text frame' that generate the conversion bug
  347.   if it's a conversion bug ).
  348. #
  349.  
  350.  
  351.  
  352.  
  353. History
  354. -------
  355. 0.4   -(internal) Detect and remove only CR & LF chrs  (23-Dec-2001)
  356.  
  357. 0.6   -(internal) Detect and remove TAB chrs
  358.  
  359. 0.9   -(internal) Detect end remove doubles (or > 2) spaces
  360.        (convert n spaces in 1 space chrs)
  361.  
  362.       -Added "Show converted text" option
  363.  
  364.       -Added "? number of columns" label
  365.  
  366.  
  367. 1.0   First public release. (04-Jan-2002)
  368.  
  369.       -Added  "number of CR, LF, TAB and Spaces removed" info
  370.  
  371.       -I have checked the files that generate the bug "B1" with DPU and other
  372.       Hex-Dump Tools too and i don't find any CR chrs after OneLine usage...
  373.  
  374.       -Speed improvement (compiled with VBCC 0.8 ---faaaster!!---)
  375.  
  376.  
  377. 1.1   -Added Overwrite request
  378.  
  379.       -OneLine now allocate the needed memory before starting conversion
  380.  
  381.       -Added 'File length' infos
  382.  
  383.       -Added '-d' option to switch on/off the "Erase multiples spaces" feature
  384.  
  385.       -Added 'Comma Optimize' option: erases the spaces before commas and add
  386.        one space after (comma) if isn't;
  387.  
  388.        i.e. "number of CR , LF ,TAB and Spaces removed"
  389.                              ||
  390.                              \/
  391.             "number of CR, LF, TAB and Spaces removed"
  392.  
  393.       -Some speed emprovements (if it's used without the options)
  394.  
  395.  
  396. 1.2   -Rewritten the check of the options; now can type a line like this:
  397.        "OneLine SYS:infile -tdc ram:outfile"
  398.  
  399.       -Added '-l' option to switch on/off the CR-LF erasing.
  400.  
  401.       -Added VERSION Tag
  402.  
  403.       -Added 'A' Option
  404.  
  405.       -Added check of the input file ( is ASCII ??).
  406.  
  407.       -Added ".", ":", ";" checks to the "Comma Option" (-c)
  408.  
  409.       -Added '-p[n]' to leave the begin/end Paragraph codes,
  410.        and  [n]  lines beetween the paragraphs    (thanks to D.Robb)
  411.  
  412.       -Added 'e' option to find a possible type error
  413.  
  414.       -Added 'File Protection' info & check
  415.  
  416.  
  417. 1.3   (25-Mar-2002)
  418.  
  419.       -Totally rewritten, except some conversion's functions
  420.  
  421.       -Added a GUI (thanks to Jon Peterson)
  422.  
  423.       -Added '"', ']', ')' to the 'Comma Option' (thanks to AntCer #)
  424.  
  425.       -Added 'Save TO' Option to Save the Converted text with the 
  426.        specified number of columns
  427.  
  428.       -Added 'Print' Option: only an easy print >PRT:
  429.  
  430.       -Added a "check & erase spaces" at line's begin
  431.        (any new option: included in "Multiple-Spaces" option)
  432.  
  433.       -Removed [n] in 'p[n]' option to set the lines beetween
  434.        the paragraphs; the option 'p' it's present always
  435.  
  436.       -Improved the checking with the 'e' & 'c' options
  437.  
  438. 1.3.1 (05-Apr-2002)
  439.  
  440.       -Fixed a little bug in the installer:
  441.        OneLine alwais said that your OS version it's bad
  442.        (my error of typing: '48' instead '40' in version_check)
  443.  
  444.       -When the printer finds a CR, she don't go at NewLine,
  445.        ...and overwrite the old line:
  446.        isn't a bug, but, to avoid this, OneLine now 
  447.        print a "__CR__" string and go at NewLine.
  448.  
  449.       -Minor improvements and a smaller executable (48812 vs 51472)
  450.  
  451. 1.3.2 (19-Apr-2002)
  452.  
  453.       -GUI section: various minors improvements & bug fixes;
  454.  
  455.       -Fixed a problem in the OneLine Internal Viewer
  456.        (when a CR was found)
  457.  
  458.       -Bug: if the input file is too small, OneLine said that isn't ASCII.
  459.        Fixed.
  460.  
  461.       -Bug: OneLine don't add a space before the first comma '"',
  462.        if it is near a word.
  463.        Fixed.
  464.        
  465.       -Smaller executable (44936 vs 48812)
  466. #
  467.  
  468.  
  469.  
  470.  
  471. THANKS TO:
  472. ----------
  473.  
  474. --> Nico Francois        for  ReqTools.library
  475. --> Manolis S. Pappas    for  MPFonts
  476. --> Volker Barthelmann   for  Vbcc
  477.  
  478. ->>->> ...and Paochi (A1200T), AntCER(UAE), MrCiccio(A4000)
  479.           FROM  #AmigaITA  IRC
  480.        ...for testing, suggestions  ...and patience!!!
  481. #
  482.  
  483.  
  484.  
  485.  
  486. ME!
  487. ---
  488. Vincenzo Barbarulo
  489. C.so Mazzini
  490. Cava de' Tirreni (SA)  84013
  491. ITALY
  492.  
  493. barbarulo.vince@infinito.it
  494.  
  495. P.S.:sorry if my english isn't very good!!!!
  496. #